home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / prg_casm / recio215.zip / README < prev    next >
Text File  |  1996-10-26  |  4KB  |  106 lines
  1. recio, Version 2.15, Release October 26, 1996.
  2. Copyright (C) 1994-1996, William Pierpoint.
  3.  
  4.  
  5. Description
  6. -----------
  7. Tired of being tripped up by scanf?  Looking for a way to read old 
  8. mainframe data into your c program?  Need to handle the year 2000 
  9. problem?  Then the RECIO C library is for you!
  10.  
  11. The RECIO C library consists of a set of functions that make it simple 
  12. to read and write text files in which each line is treated as a data 
  13. record, and each record is subdivided into fields.  Fields may be 
  14. delimited either by a character, such as a comma, or by column positions.  
  15. Field types available are integer, unsigned integer, long, unsigned long, 
  16. float, double, time_t, struct tm, character, and string.  The RECIO C 
  17. library is easy to learn because (1) functions are based on analogous 
  18. counterparts in stdio and (2) function names are based on a consistent 
  19. set of mnemonics.
  20.  
  21.  
  22. Getting Started
  23. ---------------
  24. First check the MANIFEST file for brief one line descriptions of the files 
  25. in this release.
  26.  
  27. Learning the RECIO functions will be easier if you read the documentation 
  28. in the following order:
  29.  
  30. TUTOR.TXT  - Introductory material including some simple example programs.
  31. USAGE.TXT  - Shows the typical order in which functions are used.
  32. SPEC.TXT   - Specification of all functions and macros.  Use as reference.
  33. TIPS.TXT   - Tips and ideas on using the recio functions.
  34. DESIGN.TXT - Design and development notes.
  35.  
  36. To save disk space, this package contains the executable for only one of 
  37. the test programs.  Source for other test programs is included.  To make 
  38. all the test programs, see MKTEST.BAT.  This package also contains the 
  39. libraries for only the SMALL and LARGE memory models.  To make libraries 
  40. for all memory models, see MKLIBS.BAT.
  41.  
  42. All you need to do to use the recio functions in your application is to
  43.  
  44. #include "recio.h"
  45.  
  46. in your source code and link using the recio library for the memory model 
  47. you are using.  For example, if using the small memory model, link with 
  48. RECIOS.LIB.  If you use a compiler other than Borland C 3.1, you will need 
  49. to recompile the source code.
  50.  
  51. If you use the recio library regularly, then you may wish to copy recio.h 
  52. to your compiler's INCLUDE directory and copy the recio libraries to your 
  53. compiler's LIBRARY directory.  You can then 
  54.  
  55. #include <recio.h>
  56.  
  57. in your source code and link to the recio library using the compiler's 
  58. default paths.
  59.  
  60.  
  61. Source Code
  62. -----------
  63. Complete C source code for RECIO is provided.  To recompile, you will need 
  64. an ANSI-C compatible compiler.  This release used Borland C 3.1.  MKLIBS.BAT 
  65. will generate all the libraries for this compiler.  Modify the MAKEFILE to 
  66. reflect your setup and to set the memory model.  To use another compiler, 
  67. you will need to generate libraries or object code for that compiler.  To 
  68. port to another compiler, you can find useful information in section 3 of 
  69. the file DESIGN.TXT and in the file PORTABLE.
  70.  
  71.  
  72. Distribution
  73. ------------
  74. This is free software; you can redistribute it and/or modify it under the 
  75. terms of the GNU Library General Public License, Version 2, June 1991, 
  76. as published by the Free Software Foundation.
  77.  
  78. This software is distributed in the hope that it will be useful, but 
  79. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY 
  80. or FITNESS FOR A PARTICULAR PURPOSE.  More details on the GNU Library 
  81. General Public License can be found in the file COPYRITE.
  82.  
  83. You should have received a copy of the GNU Library General Public License 
  84. along with this program; if not, write to the Free Software Foundation, Inc., 
  85. 675 Mass Ave, Cambridge, MA 02139, USA.
  86.  
  87.  
  88. Archive
  89. -------
  90.  
  91. The public version of the RECIO library is available from the SimTel 
  92. software repository on the Internet and from many mirror sites.
  93.  
  94. Announcements of new versions of the recio library are made in the 
  95. USENET newsgroup comp.archives.msdos.announce.  
  96.  
  97. Another way to locate copies of the recio library is to use a WWW 
  98. search engine such as www.filez.com.
  99.  
  100.  
  101. Author
  102. ------
  103.  
  104. If you have any comments about the RECIO C library, please e-mail them 
  105. to the author, Bill Pierpoint, at wpierpoint@aem-east.com
  106.